home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / util / boot / welcome.lha / WELCOME.DOC < prev   
Text File  |  1994-01-09  |  9KB  |  233 lines
  1.  
  2.  
  3.  
  4. WELCOME                     USER COMMANDS                    WELCOME
  5.  
  6.  
  7.  
  8. NAME
  9.      welcome - displays a message with a little logo during the boot
  10.      sequence or while loading an user program
  11.  
  12. SYNOPSIS
  13.      welcome [-iimage] [-sseconds] [-1string] [-2string] [-3string]
  14.              [-xcoordinate] [-ycoordinate]
  15.      welcome [-iimage] [-sseconds] [-pprogram]
  16.              [-xcoordinate] [-ycoordinate]
  17.  
  18. DESCRIPTION
  19.      welcome is a  little  utility that  displays a message when you
  20.      bootstrap your Amiga. You can run it from your startup-sequence
  21.      and tell it how many seconds  to wait  displaying  the selected
  22.      message. The standard message -when you run welcome without any
  23.      parameter- is  ' Welcome to Amiga! ' (if you have used an Apple
  24.      Mac you probably are familiar with this message).
  25.  
  26.      The flags:
  27.        -iimage  selects an image. There are actually  four images in
  28.                 this version of the  program. If you use  -i1 or -i3
  29.                 you have selected a small image otherwise, with  -i2
  30.                 or -i4,  a big one. Default is 1.
  31.        -sseconds selects  the  number  of   seconds  to   wait after
  32.                 the message is displayed on screen. Default is 5 and
  33.                 the maximum is 999 seconds.
  34.        -xcoordinate is the x coordinate of the window.  The  default
  35.                 settings of (x,y) coordinates are for a  640x256 pal
  36.                 screen. If  you  have  a  Workbench with a different
  37.                 default  resolution  (i.e.  1280x512 or VGA 640x480)
  38.                 change this parameter. An error occurs if, with your
  39.                 setting, the window goes out of screen.
  40.        -ycoordinate is like the -xcoordinate, but for the y  coordi-
  41.                 nate.
  42.        -pprogram this option is mutually exclusive with -1,-2 and -3
  43.                 option. It's used to display the message ' Loading ' 
  44.                 program_name  ' please wait... '. Here  program_name
  45.                 is a name you want to display. If you do not specify
  46.                 any name (i.e. only -p ) no  name is displayed, only
  47.                 ' Loading   please wait... '. If the  name you  want
  48.                 to display have blanks use: "-pname with spaces".
  49.                 The name you can display is twenty chars long, extra
  50.                 chars aren't displayed.
  51.        -1string is used to display the first string of your message.
  52.                 The default string is ' Welcome '.
  53.                 The name you can display is twenty chars long, extra
  54.                 chars aren't displayed.
  55.        -1string is used to display the second string of your message
  56.                 and the default string is ' to '.
  57.                 The name you can display is twenty chars long, extra
  58.                 chars aren't displayed.
  59.        -1string is used to display the third string of your message.
  60.                 The default string is ' Amiga '.
  61.                 The name you can display is twenty chars long, extra
  62.                 chars aren't displayed.
  63.        ?        with this  option  you  can  use  the  help  on line
  64.                 facility.
  65.  
  66.  
  67. EXAMPLES
  68.      from shell type the follow:
  69.  
  70.        welcome -i2 -s2 "-pDeluxe Paint AGA"
  71.  
  72.        welcome -i1 -s5 -1This "-2is a demo of" -3Welcome
  73.  
  74.        welcome -s2
  75.  
  76.        welcome -p
  77.  
  78.        welcome -x10 -y40 -i4
  79.  
  80.        welcome -i1 -s5 -1This -x10 "-2is a demo of" -3Welcome -y60
  81.  
  82.  
  83. BUGS
  84.      NONE KNOWN !!!
  85.      There is only a little problem (not a bug !!!) if you use fonts
  86.      (under OS 2.0, 2.1 or 3.0) with size larger than 8x8 pixels.You
  87.      can see garbage instead of your message ! Really the problem is
  88.      that I have not set in my  C program  a  font. I  have used the
  89.      standard system font (topaz 8). I have tested the  program with
  90.      topaz 11 and all works fine, but with  topaz 24 ...
  91.      Since I have not changed the standard font in my default confi-
  92.      guration I don't need to fix this problem, but if  I'll receive
  93.      some money for my program you probably have a chance I fix it.
  94.  
  95.  
  96. DIAGNOSTIC
  97.      The program  has  self explaining  messages  for handle strange
  98.      cases.
  99.  
  100.  
  101. FUTURE DIRECTIONS
  102.      Fixing the little problem with fonts.
  103.      The possibility to load different images, so you can  draw  and
  104.      display your personal image.
  105.      Support of 8,16,32,64,126 and 256 colors images.
  106.  
  107.    
  108. THANKS
  109.      Alessandro Benedettini would like to thank the following
  110.       (and in no fucking way is this in order of priority):
  111.  
  112.        Ivan      'cause he passed to me some CD that I have played
  113.                  during the developing and debugging phase of this
  114.                  program
  115.       Massimo    'cause he bought SAS C V5.1 that had passed to me
  116.      Giancarlo   for games and programs he swapped with me and for
  117.                  his beta testing on AGA machines
  118.      Giacinto    for the SAS C 6.00 update, for the  modem support
  119.                  and beta testing on his ECS (Fat Agnus) machine
  120.        Didi      (he is my little cat) for the great moral support
  121.                  during developing and debugging phases
  122.  
  123.      and all the Guys who made and are the Amiga ...
  124.  
  125.  
  126. AUTHOR
  127.  
  128.      WELCOME was written by
  129.  
  130.  
  131.             Alessandro Benedettini
  132.                Via Moretta, 32
  133.                 10139 Torino
  134.                ITALIA (ITALY)
  135.  
  136.  
  137.      send MONEY, comments, disks to this address
  138.  
  139.  
  140. REQUIRED HARDWARE
  141.      welcome needs only a standard Amiga.
  142.  
  143.  
  144. TESTED ON THIS HARDWARE & SOFTWARE CONFIGURATIONS
  145.      Amiga 500 (rev.5) with standard 512k chip set (PAL), A501 512k
  146.      expansion, 2MEGA fast ram, 120MEGA HD, 880k external drive and
  147.      rom v2.04 (37.175), Workbench V37.67, color monitor.
  148.  
  149.      Amiga 2000 (rev.6.xx) with 1MEGA ECS Agnus, rom v1.3 (*)
  150.  
  151.      Amiga 1200 AGA standard (rom v3.0) (*)
  152.  
  153.      Amiga 4000 AGA (68040/25 MHz), with 8MEGA fast ram, rom v3.0,
  154.      1960 monitor (*)
  155.  
  156.      Amiga 1200 AGA with 4MEGA fast ram, rom v3.0, 1942 monitor (*)
  157.  
  158.      Amiga 500 (rev.5) with standard 512k chip set (PAL), A501 512k
  159.      expansion, 2MEGA fast ram, 120MEGA HD, 880k external drive and
  160.      kickstart  v1.3 (34.5) loaded from disk, Workbench  V34.20 and
  161.      colour monitor. (**) (***)
  162.  
  163.      Amiga 500 (rev.5) with standard 512k chip set (PAL), A501 512k
  164.      expansion, 880k external drive and rom v1.2, Workbench  V34.20
  165.      and colour monitor. (***)
  166.  
  167.      Amiga 500 (rev.5) with standard 512k chip set (PAL), A501 512k
  168.      expansion, 880k external drive and kickstart v1.3  loaded from
  169.      disk, Workbench  V34.20 and colour monitor. (**) (***)
  170.  
  171.   (*) in 19/7/1993 I have finished the program but not passed to my
  172.       beta testers.
  173.  
  174.  (**) you have the visit of Guru (#81000005 - Corrupted memory list)
  175.       if you use the -i option. Why ? Is it a problem  with my  copy
  176.       of kickstart (from disk) ? Well, do not use that flag or buy a
  177.       copy of kickstart 2.0. I have no intention to fix this bug !
  178.  
  179. (***) with old kickstart (V1.2 or V1.3) the colors are ... strange !
  180.       Sorry ! No my fault ! Please, consider that I have  kick v2.04
  181.       and have not changed the standard colors ...
  182.  
  183.  
  184. MATERIAL USED DURING DEVELOPING AND DEBUGGING
  185.      An Amiga (of course !)
  186.      SAS C Compiler V6.00 (great program !)
  187.      TXED+ V2.2
  188.      GOMF V2.2
  189.      Deluxe Paint V4.5 AGA
  190.      ILBM2C (by Tim Kemp)
  191.      Power Windows V2.5
  192.      Grabbit V1.0
  193.      Internal developing tools (by Alessandro Benedettini)
  194.      Amiga Programmer's Handbook (by  Eugene P. Mortimore) - Italian
  195.       version by IHT
  196.      Mapping the Amiga (by Anderson & Thompson) - Compute! Books
  197.      Some CDs (Queen, Guns'n'Roses, Renato Zero, Vasco Rossi,
  198.       J.S.Bach, L.V.Beethoven)
  199.      A Cd player
  200.      Aiwa amplifiers (thanks Mario !)
  201.      Food (thanks mamma !)
  202.      A can of Amiga Cola
  203.      ...
  204.  
  205. FINAL CONSIDERATIONS
  206.  
  207.      I would like to thank Todd J. Petit for his Billboard v2.0 that
  208.      has inspired my Welcome program. In particular  I have  grabbed
  209.      and modified the 'bored men' from Billboard. S o r r y, Todd  !
  210.      I need images for my program and I have not  a lot  of time  to
  211.      paint ... I' ll change that image  as soon as  possible, please
  212.      do not use it. Todd if you contact me (in Billboard there isn't
  213.      your address, and I have only the executable, no docs...) I' ll
  214.      send you my source code ...
  215.  
  216.      If you use Welcome, please send me an offer.  NOT all  programs
  217.      used to write Welcome are originals (but ** NOT **  bought from
  218.      crackers, they  were passed  to  me by  friends  who  have  the
  219.      originals) and I want to buy the originals !  But I  have not a
  220.      great budget (I'm a student...).
  221.  
  222.  
  223. RELEASED
  224.      on Monday 20/07/1993 Version 1.0.9 beta
  225.  
  226.      An Alessandro Benedettini's Production.
  227.      (C)1988/1993 by Alessandro Benedettini.
  228.  
  229.  
  230.  
  231.  
  232.                                                      END OF DOCUMENT
  233.